BBS in a Box 3/BBS in a box - Trilogy III.iso/Files/System7 tools/Powerbook/PBTools 1.2/SafeSleep™ Read Me

Text File | 1992-03-23 | 5.7 KB | 77 lines | [TEXT/MSWD]

SafeSleep™ is Copyright ©1992 Bill Steinberg. All Rights Reserved. SafeSleep is free. This document
describes version 1.2 of SafeSleep. If you distribute SafeSleep™, it must be free, and you must include
this documentation.

SafeSleep is a small System Extension (aka INIT) for the PowerBooks. Though I haven't tested it on a
Mac Portable, I suspect it will work fine on that too. SafeSleep will not load on any Mac which does not
have the Power Manager. SafeSleep blanks the screen and requests a password whenever a sleeping Mac
is awakened. I wrote SafeSleep after I came back from lunch one day to find a co-worker looking at the
screen on my PB100. He was curious about my new PowerBook, opened it, and hit a key... Fortunately,
he was a friend, and didn't know enough about Macs  to cause any damage <grin>.

Version 1.x of SafeSleep is pretty simple. Though it will soon be a Control Panel (instead of a System
Extension) for easy configurability, I wanted to release it now, rather than a month or so from now,
when I'll have a chance to finish the Control Panel interface. For now, you need ResEdit to change any of
the defaults, including changing the default password, which is "Password" (no quotes, the capital P is
significant).

Just drag the SafeSleep Extension into your System Folder; if you're running System 7, the Finder will
put SafeSleep into the Extensions Folder (which is where it belongs if you're running System 7). The
next time you boot, SafeSleep will be loaded. If you use an INIT Manager, make sure you tell it to load
SafeSleep.

Once loaded, SafeSleep stays dormant until your PowerBook goes to sleep, at which point SafeSleep
clears your screen. When your Mac is awakened, SafeSleep puts up a small window requesting your
password. If the correct password is not entered in 30 seconds, SafeSleep puts the PowerBook back to
sleep. You can change the password, and you can change the amount of time SafeSleep waits for the
correct password. You can also instruct SafeSleep to wait until wakeup time before clearing your
screen (giving the person waking up your Mac a second or so view of what was being displayed when
your Mac went to sleep).

SafeSleep is NOT a foolproof security device; it only provides simple protection against casual access to
your sleeping PowerBook. If your PowerBook is rebooted, SafeSleep will NOT automatically engage until
your Mac goes to sleep and wakes up for the first time. If you need foolproof security, you'll need to look
to one of the commercial or shareware  security programs. If you just want to keep idle hands from
accessing your PowerBook, SafeSleep should do the trick for you. When I get around to writing the
Control Panel interface, I may add the ability for SafeSleep to protect across reboots. I will NOT,
however, be adding the ability to protect against booting from another disk, or from disabling the
SafeSleep Control Panel.

While the SafeSleep window is up, just type in your password to dismiss it. Case IS significant, and the
return key is NOT needed at the end of your password.  Any time an incorrect character is entered, the
compare is reset (silently) and the whole password must be re-entered.  If you mess up entering the
password, just type any chatacter that is NOT in your password (return is ok, as return is normally
NOT part of the password), and then type it again. If you set SafeSleep to wait until wakup time before
clearing the screen, you may "type ahead" your password while SafeSleep is clearing your screen.

To change the password, you'll need ResEdit. The password is stored in STR  resource number 128 in
the SafeSleep file. The default password is "Password". (No quotes, the capital P is significant). You can
change this to anything you can type. If you enter a password that is longer than 255 characters,
ResEdit will truncate it to the first 255 characters. If you enter returns into the password string when
you configure it, you'll have to enter them when SafeSleep is prompting you too.

To change the amount of time you have to enter the password, you'll need to edit the SSr resource. I
have included a ResEdit TMPL resource in the SafeSleep file to aid you in editing the SSpr resource.
The first item in the SSpr resource is a long integer holding the number of ticks (60ths of a second)
that SafeSleep will wait for the password to be entered. The default value is 1800 ticks, or 30 seconds.
You can change it to whatever you like, but note that you should allow enough time to actually enter the
correct password. Normally there should be no reason for you to change the value from 1800 ticks. You
do NOT want to increase it to some huge number;  If you do, and someone who doesn't know the correct
password wakes your PowerBook, it will not go back to sleep before its battery dies. The other field in
the SSpr resource is the "Clear Screen before Sleeping" field. SafeSleep normally clears the screen
when your PowerBook goes to sleep (so there is nothing visible to the person waking up your Mac). If
you prefer SafeSleep to wait until your Mac wakes up before clearing the screen, change the "Clear
Screen before Sleeping" field to 0. You might want to do this if the 1 to 2 second screen clear delay at
sleep time annoys you. Change this field back to 1 to have SafeSleep clear the screen when your
PowerBook goes to sleep, rather then when it wakes up.

Version 1.0 - Release
Version 1.1 - Added ability to clear screen at sleep time as well as at wakeup time.
Version 1.2 - Network warning dialogs (eg when AppleTalk is running), no longer appear when SafeSleep
forces sleep due to incorrect password (or no password) being entered in time.

Bill Steinberg - Sat, Mar 21, 1992
CompuServe 76703,1027 (Preferred)
AppleLink X0542